home *** CD-ROM | disk | FTP | other *** search
/ Bible Heaven / Bible Heaven.iso / windows / smwindem / olb_read.me < prev    next >
Text File  |  1994-03-12  |  14KB  |  256 lines
  1.       ╔═════════════════════════════════════════════════╗
  2.       ║            SeedMaster OLB_READ.ME               ║
  3.       ║ Copyright (c) 1993 White Harvest Software, Inc. ║
  4.       ╚═════════════════════════════════════════════════╝
  5.  
  6. This is intended to provide users of the Online Bible program an intro-
  7. duction to the Online Bible file format compatible version of SeedMaster.
  8.  
  9. HISTORY
  10. ~~~~~~~
  11. Around April 1993, Larry Pierce, author of Online Bible, provided White 
  12. Harvest (among others) with C source code to access his Online Bible 
  13. files. We used it to implemented Online Bible databases into our Seed-
  14. Master/DOS V2.3 program. Since we already had a mature Bible study pro-
  15. gram, it only took about 2 weeks to implement and we went into beta test 
  16. in late June, 1993. Though our file structures are almost the complete 
  17. opposite of Online Bible's (see below), the modularity of the code Larry 
  18. provided and the modular design of our program made the task possible.
  19.  
  20. OUR TECHNICAL VIEW OF THE ONLINE BIBLE PROGRAM
  21. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  22. From a programming standpoint, the Online Bible program is quite a feat.
  23. Larry uses the PL/1 language, and he must use an old, "small memory 
  24. model" compiler to create his program. "Small memory model" means he is
  25. limited to only 64K of code (programming) and lacks overlay support. That 
  26. he has been able to cram as much function into 64K as he has is amazing.
  27. We use the C language and do not have that limitation. Frankly, we 
  28. probably wouldn't have tried this kind of a program if we did.
  29.  
  30. OUR APPROACH TO ONLINE BIBLE DATABASES
  31. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  32. We have not sought to purely "clone" the Online Bible program. We already
  33. have a mature Bible study product, so we have implemented Online Bible
  34. databases within our existing structure. We have tried to add, where 
  35. possible, features to help ease the evaluation or transition for an Online
  36. Bible user to our program. 
  37.  
  38. BIBLE DATABASES SUPPORTED
  39. ~~~~~~~~~~~~~~~~~~~~~~~~~
  40. Generally, we support Online Bible databases that use the "standard"
  41. KJV 31,102 verse layout. As this is released, we are not aware of any
  42. particular databases that are not supported. It is likely that only a
  43. few foreign languages will cause difficulty.
  44.  
  45.  * We know that V6.X files are supported. Older versions may work as
  46.    well. We would guess that V5.X and up would work if they use the 
  47.    31,102 format (most English translations will).
  48.  * We know V6.0 SCHOLAR, AV-LSG, AV-RSV, AV-ELB, ELB and AV-NRSV work.
  49.  
  50. Please let us know your experiences. (We realize that we'll hear from
  51. more that don't work than those that do.) We'll list them on our BBS
  52. as we get the feedback.
  53.  
  54. TEXT-BASED RESOURCE SUPPORT
  55. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  56. We support the Online Bible text resources in two ways:
  57.  * We support the native Online Bible format with certain limitations.
  58.    First, files are only access read-only any changes you make are
  59.    NOT SAVED. Second, you cannot Search the resources as you can with
  60.    our format. Third, this format is slower than ours. If you use this
  61.    format and use the DIET compression, you are responsible to load 
  62.    and unload DIET appropriately.
  63.  * We have included a conversion program, OLB2SM.EXE, to convert Online 
  64.    Bible text resources to our format. Instead of spreading text files 
  65.    across many directories, OLB2SM concatenates the text, (stripping 
  66.    extraneous hard returns and spacing to display more info on the 
  67.    screen at one time) and builds two files:  
  68.     * A Text file (ends in .DAT or .SMC)  
  69.     * An Index file (.NDX)
  70.    Again, there are benefits to this approach. First, more efficient 
  71.    disk space usage. Second, faster text access. Third, you can edit
  72.    and update the text. Finally, you can search textual resources. You 
  73.    can search the TSK, Lex, etc., for words or numbers and "page" thru 
  74.    the hits. 
  75.    OLB2SM has a special "Demo" option to convert only a portion of the 
  76.    text resources to conserve disk space while you test and evaluate SM.
  77.    If used, the following limitations are in effect:
  78.     TOPICS:  Only the first 1000 topics are converted.
  79.     WORD P.: Only Matt through Luke.
  80.     SCOFIELD, TREASURY, PEOPLE'S, & NOTES: only Gospel of John.
  81.    See the OLB2SM.DOC file for more details.
  82.  
  83. SUMMARY OF BENEFITS
  84. ~~~~~~~~~~~~~~~~~~~
  85. The SM/DOS has some basic program features not found in Online Bible:
  86.    * The ability to run more than one Online Bible database (combin-
  87.      ation or single) at the same time. For instance, you can run side 
  88.      by side windows of the Darby Bible (found in SCHOLAR) beside the 
  89.      LSG (found in AV-LSG) and scroll them together.
  90.    * The ability to run SeedMaster databases beside Online Bible data-
  91.      bases. For instance, you can scroll/search our NKJV, Living Bible, 
  92.      or TEV Bible databases beside your Online Bible texts.
  93.    * An exhaustive list of all Words in a database. You can look up and
  94.      scroll words alphabetically and search directly from our Word List.
  95.    * An integrated text editor. You can edit verse by verse notes or
  96.      the text Resources within SeedMaster with the Bible verses still
  97.      on the screen.
  98.    * Different search result display. SeedMaster displays each search
  99.      verse on a single line with the reference, then a fragment of the
  100.      text to the right. This lets you see and screen about 20 verses at
  101.      a time on a standard 25 line screen. To see the full text of the
  102.      verse in context, you simply press <Enter> on it.
  103.    * Search Statistics - a book by book and chapter by chapter summary
  104.      of search "hits".
  105.    * Searches can be saved and merged using AND, OR, XOR, NOT logic.
  106.    * You can search the Text Resources (TSK, etc.).
  107.  
  108. SPECIAL "TWEAKS" FOR ONLINE BIBLE USERS
  109. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  110. We have implemented an alternative function key mapping to let you try
  111. out SeedMaster using most of the familiar Online Bible function keys. 
  112. You can do this three ways:
  113.    * Start SM with the special "=O" option. This will force Online Bible
  114.      key usage and status line prompts in View, Search and Commentarys.
  115.      Example:  SM =O  <Enter>
  116.    * Press <Shift><F1> to toggle Online Bible function key translation
  117.      on and off. Note the status line will change to reflect the new keys.
  118.    * Press <Home> once, then type the Online Bible function key. Note
  119.      that the status line will NOT change when you press <Home>.  
  120.    * Online Bible has some undocumented, basic "WordStar" cursor keys.
  121.      These are now supported by SeedMaster.
  122.    * If you have extended memory and have HIMEM.SYS loaded in your
  123.      CONFIG.SYS file, SM will cache Online Bible files into this high
  124.      memory. Speeds, even for multiple databases, are pretty quick.
  125.  
  126. ABOUT OUR SHAREWARE REGISTRATION
  127. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  128. The distribution of Online Bible is unique, as Larry seeks no compen-
  129. sation for his work. His financial needs are met via other means. 
  130. Frankly, we do not enjoy that freedom. We are sympathetic to his approach, 
  131. as we distribute SeedMaster as Shareware. We ask those who find the
  132. program useful to register their use with us for $30. This includes:
  133.    * Putting you on our mailing list for updates/enhancments
  134.    * Sending a full, printed and indexed manual (over 90 pages)
  135.    * Sending the latest version of our progam, and
  136.    * Providing us compensation for our efforts.
  137.  
  138. Please note that the requested registration fee is ONLY for the use of 
  139. our program. We DO NOT ask any additional registration fees for each 
  140. "Shareware" Bible database. (If you obtain them from us, our fees cover 
  141. duplication expenses, etc.). We allow people to freely copy our non-copy-
  142. righted (non-royalty) Bible databases (we obtained many from Online 
  143. Bible). We simply ask to be compensated for our efforts in creating and 
  144. enhancing the program. This is where we spend the bulk of our time. 
  145.    (For more information, see Registration Info on the Help Menu.)
  146.  
  147. SUGGESTIONS / QUESTIONS
  148. ~~~~~~~~~~~~~~~~~~~~~~~
  149. We are always open to suggestions and questions. Be gentle, but
  150. direct. You can contact us at:
  151.     White Harvest Software, Inc.
  152.     PO Box 97153
  153.     Raleigh, NC 27624-7153  U.S.A.
  154.     Voice/Fax: (919) 870-0775 
  155.       (To reach the Fax, press your "Go" or "Start" button BEFORE
  156.        you hear our phone ring.)
  157.     BBS: (919) 846-2141
  158.  
  159. WHICH BIBLE DATABASES (SM or OLB) SHOULD YOU USE?
  160. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  161. As stated earlier, Online Bible databases are designed very differently
  162. from our native SeedMaster databases. Naturally, Larry prefers his format, 
  163. and we prefer ours. Nevertheless, the following is our best attempt at 
  164. an objective assessment the differences between the two designs:
  165.  
  166. Because of the Online Bible program's "small memory model", Larry has 
  167. had limited code space and gobs of memory left over to "cache" files 
  168. in memory. So, Larry designs very tightly coded and compressed Bible 
  169. texts and indexes. He loads key index and decompression files (100K to 
  170. 200K) into memory for fast access. Otherwise, access speed would be 
  171. rather slow. On your hard disk, therefore, his databases are smaller 
  172. than ours. Because Online Bible must have so much information in memory, 
  173. it can only run one database at a time (which is one reason for the 
  174. "combination" databases).
  175.  
  176. We have never had significant code space limitations. We emphasized:
  177.    * Minimizing hard disk accesses 
  178.    * Conserving memory space, and
  179.    * Providing any combination of Bible databases simultaneously. 
  180. The memory required to decompress one of our databases is only about 5K. 
  181. We also need very few hard disk accesses, so we do not need to cache 
  182. our indexes for speed. The penalty we pay for this is larger database 
  183. files (about 4MB each version). It has been our position that hard disk 
  184. space is "cheap", at least compared with a user's study options and time. 
  185. Therefore, we prefer to err on the side of large files to gain greater 
  186. flexibility and speed. When we run Online Bible databases, we performed 
  187. some "tweaks" and we do try to cache key files (to extended memory if
  188. you have HIMEM.SYS loaded in your CONFIG.SYS). However, if your memory 
  189. is limited, access to Online Bible databases will be slow. Under the 
  190. same constraints, our databases WOULD NOT suffer speed degradation.
  191.  
  192. There are other related differences:
  193.  * Online Bible databases do not index all words. They leave out very
  194.    common words such as "the", "and", etc. SeedMaster databases ex-
  195.    haustively index all words.
  196.  * Online Bible databases do not support paragraph markers (or hard
  197.    returns) within the text of a verse--such as in poetry sections.
  198.    SeedMaster databases do support them, when we have that information
  199.    (as in the NIV, TEV, TLB and other databases).
  200.  * In Online combination databases, words are indexed across all Bible
  201.    texts. If a program wants to find out if a word is used only in a 
  202.    given translation, it must read in all possible verses and check for
  203.    that word (slow). All SeedMaster databases are indexed separately.
  204.  
  205. So, we would counsel as follows (this presumes you use our program and
  206. therefore have a choice of databases):
  207.  * If your hard disk space/budget is constrained, use Online Bible
  208.    databases. Note, however, if you use multiple Online Bible data-
  209.    bases, the disk savings can decrease due to the duplication of 
  210.    the AV and Strong's numbers in each database.
  211.  * If your DOS memory is too constrained to run Online Bible databases
  212.    quickly--or if you want maximum flexibility in database combinations, 
  213.    use SeedMaster databases. You will find them rather affordable (none 
  214.    over $30).
  215.  
  216. In summary, there is nothing really "wrong" or "evil" about either design 
  217. approach. They reflect both personal philosophies and technical con-
  218. straints. Between them, they do offer a rather complete range of choice 
  219. for the Bible student. We hope you use them to their best advantage.
  220.  
  221. SPECIAL ONLINE BIBLE DATABASE IMPLEMENTATION COMPROMISES
  222. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  223.  * SEARCH WORD VERIFICATION: Because SeedMaster displays so many more
  224.    search verses at a time, and because background verification of
  225.    words in a particular text is impractical, as a default, we do not 
  226.    verify the existance of a word in a given text as Online Bible does. 
  227.  * NO STRONG'S IN WORD LIST: We could not justify implementing Online 
  228.    Bible Strong's numbers in our Word List as we do with the SeedMaster 
  229.    version. If you have the SeedMaster STR database, the Word List 
  230.    lists each Strong's number, the Greek/Hebrew word, and the most 
  231.    common AV rendition. The STR has a special file to provide this 
  232.    information quickly. This data is not quickly available within
  233.    Online Bible databases. Since most of the benefit is the supple-
  234.    mental information that we lack, we did not implement it.
  235.  * CROSS REFERENCE NUMBERS: If you run the cross-references (F10) on 
  236.    Gen 1:1 within Online Bible, it will say 78 verses. In SeedMaster,
  237.    you will get 75. The difference is that 3 verses are listed twice,
  238.    but both give you the same verses to look at.
  239.  * CONVERTING WORD PICTURES: Broadman Press permits Online Bible to
  240.    distribute all 6 volumes royalty-free. They did not choose to do so 
  241.    with our program. We must pay royalties on volumes 5 & 6, and are 
  242.    constrained to only sell them direct. Since OLB2SM converts RWP files 
  243.    to our format, we could be held liable for royalties on the converted 
  244.    files (which would be inumerable). Thus, we only allow OLB2SM to 
  245.    convert volumes 1-4 (copyright has expired). This is not our desire 
  246.    or decision. We do sell the complete set for an affordable $15. 
  247.  
  248. SPECIAL NOTE TO ONLINE BIBLE DEALERS
  249. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  250. We know that there is an army of dealers who sell copies of the Online 
  251. Bible program and databases. It is not our intent to damage your ministry/
  252. business. In fact, we can help. If you also offer our program, you can 
  253. continue to distribute the Online Bible files and add our Bible databases. 
  254. We can provide (at wholesale pricing) our copyrighted databases (some of 
  255. which are not available in Online Bible format). Contact us for details.
  256.